
<!DOCTYPE HTML>
<html lang="zh-hans" >
    <head>
        <meta charset="UTF-8">
        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
        <title>第1节：GitBook 从懵逼到入门 · GitBook</title>
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
        <meta name="description" content="">
        <meta name="generator" content="GitBook 3.2.3">
        <meta name="author" content="kim">
        
        
    
    <link rel="stylesheet" href="../gitbook/style.css">

    
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-highlight/website.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-search/search.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-fontsettings/website.css">
                
            
        

    

    
        
        <link rel="stylesheet" href="../styles/website.css">
        
    
        
    
        
    
        
    
        
    

        
    
    
    <meta name="HandheldFriendly" content="true"/>
    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
    <meta name="apple-mobile-web-app-capable" content="yes">
    <meta name="apple-mobile-web-app-status-bar-style" content="black">
    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="../gitbook/images/apple-touch-icon-precomposed-152.png">
    <link rel="shortcut icon" href="../gitbook/images/favicon.ico" type="image/x-icon">

    
    <link rel="next" href="食.html" />
    
    
    <link rel="prev" href="./" />
    

    </head>
    <body>
        
<div class="book">
    <div class="book-summary">
        
            
<div id="book-search-input" role="search">
    <input type="text" placeholder="输入并搜索" />
</div>

            
                <nav role="navigation">
                


<ul class="summary">
    
    
    
        
        <li>
            <a href="http://localhost:3000/customer/customerManage" target="_blank" class="custom-link">洲博通外综服务</a>
        </li>
    
    

    
    <li class="divider"></li>
    

    
        
        
    
        <li class="chapter " data-level="1.1" data-path="../">
            
                <a href="../">
            
                    
                    前言
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2" data-path="./">
            
                <a href="./">
            
                    
                    第一章 node.js
            
                </a>
            

            
            <ul class="articles">
                
    
        <li class="chapter active" data-level="1.2.1" data-path="GitBook.html">
            
                <a href="GitBook.html">
            
                    
                    第1节：GitBook 从懵逼到入门
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2.2" data-path="食.html">
            
                <a href="食.html">
            
                    
                    第2节：食
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2.3" data-path="住.html">
            
                <a href="住.html">
            
                    
                    第3节：住
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2.4" data-path="行.html">
            
                <a href="行.html">
            
                    
                    第4节：行
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.3" data-path="../Chapter2/">
            
                <a href="../Chapter2/">
            
                    
                    第二章
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.4" data-path="../Chapter3/">
            
                <a href="../Chapter3/">
            
                    
                    第三章
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.5" data-path="../Chapter4/">
            
                <a href="../Chapter4/">
            
                    
                    第四章
            
                </a>
            

            
        </li>
    

    

    <li class="divider"></li>

    <li>
        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
            本书使用 GitBook 发布
        </a>
    </li>
</ul>


                </nav>
            
        
    </div>

    <div class="book-body">
        
            <div class="body-inner">
                
                    

<div class="book-header" role="navigation">
    

    <!-- Title -->
    <h1>
        <i class="fa fa-circle-o-notch fa-spin"></i>
        <a href=".." >第1节：GitBook 从懵逼到入门</a>
    </h1>
</div>




                    <div class="page-wrapper" tabindex="-1" role="main">
                        <div class="page-inner">
                            
<div id="book-search-results">
    <div class="search-noresults">
    
                                <section class="normal markdown-section">
                                
                                <p>&#x6982;&#x8FF0;</p>
<p>GitBook &#x662F;&#x4F7F;&#x7528; GitHub / Git &#x548C; Markdown&#xFF08;&#x6216;AsciiDoc&#xFF09;&#x6784;&#x5EFA;&#x6F02;&#x4EAE;&#x4E66;&#x7C4D;&#x7684;&#x547D;&#x4EE4;&#x884C;&#x5DE5;&#x5177;&#xFF08;&#x548C;Node.js&#x5E93;&#xFF09;&#x3002;</p>
<p>GitBook &#x53EF;&#x4EE5;&#x5C06;&#x60A8;&#x7684;&#x5185;&#x5BB9;&#x4F5C;&#x4E3A;&#x7F51;&#x7AD9;&#xFF08;&#x53EF;&#x5B9A;&#x5236;&#x548C;&#x53EF;&#x6269;&#x5C55;&#xFF09;&#x6216;&#x7535;&#x5B50;&#x4E66;&#xFF08;PDF&#xFF0C;ePub&#x6216;Mobi&#xFF09;&#x8F93;&#x51FA;&#x3002;</p>
<p><a href="https://www.gitbook.com/" target="_blank">GitBook.com</a> &#x662F;&#x4F7F;&#x7528; GitBook &#x683C;&#x5F0F;&#x521B;&#x5EFA;&#x548C;&#x6258;&#x7BA1;&#x56FE;&#x4E66;&#x7684;&#x5728;&#x7EBF;&#x5E73;&#x53F0;&#x3002;&#x5B83;&#x63D0;&#x4F9B;&#x6258;&#x7BA1;&#xFF0C;&#x534F;&#x4F5C;&#x529F;&#x80FD;&#x548C;&#x6613;&#x4E8E;&#x4F7F;&#x7528;&#x7684;&#x7F16;&#x8F91;&#x5668;&#x3002;</p>
<p><img src="https://camo.githubusercontent.com/c1b6c55fca8e171120ce1fd73afcee699cc2a98f/68747470733a2f2f7261772e6769746875622e636f6d2f476974626f6f6b494f2f676974626f6f6b2f6d61737465722f707265766965772e706e67" alt="Image"></p>
<p>GitBook &#x5B89;&#x88C5;</p>
<h3 id="&#x672C;&#x5730;&#x5B89;&#x88C5;">&#x672C;&#x5730;&#x5B89;&#x88C5;</h3>
<h4 id="&#x73AF;&#x5883;&#x8981;&#x6C42;">&#x73AF;&#x5883;&#x8981;&#x6C42;</h4>
<p>&#x5B89;&#x88C5; GitBook &#x662F;&#x5F88;&#x7B80;&#x5355;&#x7684;&#x3002;&#x60A8;&#x7684;&#x7CFB;&#x7EDF;&#x53EA;&#x9700;&#x8981;&#x6EE1;&#x8DB3;&#x8FD9;&#x4E24;&#x4E2A;&#x8981;&#x6C42;&#xFF1A;</p>
<ul>
<li>NodeJS&#xFF08;&#x63A8;&#x8350;&#x4F7F;&#x7528;v4.0.0&#x53CA;&#x4EE5;&#x4E0A;&#x7248;&#x672C;&#xFF09;</li>
<li>Windows&#xFF0C;Linux&#xFF0C;Unix &#x6216; Mac OS X</li>
</ul>
<h4 id="&#x901A;&#x8FC7;npm&#x5B89;&#x88C5;">&#x901A;&#x8FC7;NPM&#x5B89;&#x88C5;</h4>
<p>&#x5B89;&#x88C5; GitBook &#x7684;&#x6700;&#x597D;&#x529E;&#x6CD5;&#x662F;&#x901A;&#x8FC7; <strong>NPM</strong>&#x3002;&#x5728;&#x7EC8;&#x7AEF;&#x63D0;&#x793A;&#x7B26;&#x4E0B;&#xFF0C;&#x53EA;&#x9700;&#x8FD0;&#x884C;&#x4EE5;&#x4E0B;&#x547D;&#x4EE4;&#x5373;&#x53EF;&#x5B89;&#x88C5; GitBook&#xFF1A;</p>
<pre><code class="lang-bash">$ npm install gitbook-cli -g
</code></pre>
<p><code>gitbook-cli</code> &#x662F; GitBook &#x7684;&#x4E00;&#x4E2A;&#x547D;&#x4EE4;&#x884C;&#x5DE5;&#x5177;&#x3002;&#x5B83;&#x5C06;&#x81EA;&#x52A8;&#x5B89;&#x88C5;&#x6240;&#x9700;&#x7248;&#x672C;&#x7684; GitBook &#x6765;&#x6784;&#x5EFA;&#x4E00;&#x672C;&#x4E66;&#x3002;</p>
<p>&#x6267;&#x884C;&#x4E0B;&#x9762;&#x7684;&#x547D;&#x4EE4;&#xFF0C;&#x67E5;&#x770B; GitBook &#x7248;&#x672C;&#xFF0C;&#x4EE5;&#x9A8C;&#x8BC1;&#x5B89;&#x88C5;&#x6210;&#x529F;&#x3002;</p>
<pre><code class="lang-bash">$ gitbook -V
</code></pre>
<h4 id="&#x5B89;&#x88C5;&#x5386;&#x53F2;&#x7248;&#x672C;">&#x5B89;&#x88C5;&#x5386;&#x53F2;&#x7248;&#x672C;</h4>
<p><code>gitbook-cli</code> &#x53EF;&#x4EE5;&#x8F7B;&#x677E;&#x4E0B;&#x8F7D;&#x5E76;&#x5B89;&#x88C5;&#x5176;&#x4ED6;&#x7248;&#x672C;&#x7684;GitBook&#x6765;&#x6D4B;&#x8BD5;&#x60A8;&#x7684;&#x4E66;&#x7C4D;&#xFF1A;</p>
<pre><code class="lang-bash">$ gitbook fetch beta
</code></pre>
<p>&#x4F7F;&#x7528; <code>gitbook ls-remote</code> &#x4F1A;&#x5217;&#x4E3E;&#x53EF;&#x4EE5;&#x4E0B;&#x8F7D;&#x7684;&#x7248;&#x672C;&#x3002;</p>
<h3 id="&#x521B;&#x5EFA;&#x4E00;&#x672C;&#x4E66;">&#x521B;&#x5EFA;&#x4E00;&#x672C;&#x4E66;</h3>
<h4 id="&#x521D;&#x59CB;&#x5316;">&#x521D;&#x59CB;&#x5316;</h4>
<p>GitBook&#x53EF;&#x4EE5;&#x8BBE;&#x7F6E;&#x4E00;&#x4E2A;&#x6837;&#x677F;&#x4E66;&#xFF1A;</p>
<pre><code class="lang-bash">$ gitbook init
</code></pre>
<p>&#x5982;&#x679C;&#x60A8;&#x5E0C;&#x671B;&#x5C06;&#x4E66;&#x7C4D;&#x521B;&#x5EFA;&#x5230;&#x4E00;&#x4E2A;&#x65B0;&#x76EE;&#x5F55;&#x4E2D;&#xFF0C;&#x53EF;&#x4EE5;&#x901A;&#x8FC7;&#x8FD0;&#x884C; <code>gitbook init ./directory</code> &#x8FD9;&#x6837;&#x505A;&#x3002;</p>
<h4 id="&#x6784;&#x5EFA;">&#x6784;&#x5EFA;</h4>
<p>&#x4F7F;&#x7528;&#x4E0B;&#x9762;&#x7684;&#x547D;&#x4EE4;&#xFF0C;&#x4F1A;&#x5728;&#x9879;&#x76EE;&#x7684;&#x76EE;&#x5F55;&#x4E0B;&#x751F;&#x6210;&#x4E00;&#x4E2A; <code>_book</code> &#x76EE;&#x5F55;&#xFF0C;&#x91CC;&#x9762;&#x7684;&#x5185;&#x5BB9;&#x4E3A;&#x9759;&#x6001;&#x7AD9;&#x70B9;&#x7684;&#x8D44;&#x6E90;&#x6587;&#x4EF6;&#xFF1A;</p>
<pre><code class="lang-bash">$ gitbook build
</code></pre>
<h5 id="debugging">Debugging</h5>
<p>&#x60A8;&#x53EF;&#x4EE5;&#x4F7F;&#x7528;&#x9009;&#x9879; <code>--log=debug</code> &#x548C; <code>--debug</code> &#x6765;&#x83B7;&#x53D6;&#x66F4;&#x597D;&#x7684;&#x9519;&#x8BEF;&#x6D88;&#x606F;&#xFF08;&#x4F7F;&#x7528;&#x5806;&#x6808;&#x8DDF;&#x8E2A;&#xFF09;&#x3002;&#x4F8B;&#x5982;&#xFF1A;</p>
<pre><code class="lang-bash">$ gitbook build ./ --log=debug --debug
</code></pre>
<h4 id="&#x542F;&#x52A8;&#x670D;&#x52A1;">&#x542F;&#x52A8;&#x670D;&#x52A1;</h4>
<p>&#x4F7F;&#x7528;&#x4E0B;&#x5217;&#x547D;&#x4EE4;&#x4F1A;&#x8FD0;&#x884C;&#x4E00;&#x4E2A; web &#x670D;&#x52A1;, &#x901A;&#x8FC7; <code>http://localhost:4000/</code> &#x53EF;&#x4EE5;&#x9884;&#x89C8;&#x4E66;&#x7C4D;</p>
<pre><code class="lang-bash">$ gitbook serve
</code></pre>
<p>GitBook &#x547D;&#x4EE4;</p>
<p>&#x8FD9;&#x91CC;&#x4E3B;&#x8981;&#x4ECB;&#x7ECD;&#x4E00;&#x4E0B; GitBook &#x7684;&#x547D;&#x4EE4;&#x884C;&#x5DE5;&#x5177; <code>gitbook-cli</code> &#x7684;&#x4E00;&#x4E9B;&#x547D;&#x4EE4;, &#x9996;&#x5148;&#x8BF4;&#x660E;&#x4E24;&#x70B9;:</p>
<ul>
<li><code>gitbook-cli</code> &#x548C; <code>gitbook</code> &#x662F;&#x4E24;&#x4E2A;&#x8F6F;&#x4EF6;</li>
<li><code>gitbook-cli</code> &#x4F1A;&#x5C06;&#x4E0B;&#x8F7D;&#x7684; gitbook &#x7684;&#x4E0D;&#x540C;&#x7248;&#x672C;&#x653E;&#x5230; <code>~/.gitbook</code>&#x4E2D;, &#x53EF;&#x4EE5;&#x901A;&#x8FC7;&#x8BBE;&#x7F6E;<code>GITBOOK_DIR</code>&#x73AF;&#x5883;&#x53D8;&#x91CF;&#x6765;&#x6307;&#x5B9A;&#x53E6;&#x5916;&#x7684;&#x6587;&#x4EF6;&#x5939;</li>
</ul>
<p><strong>&#x5217;&#x51FA; gitbook &#x6240;&#x6709;&#x7684;&#x547D;&#x4EE4;</strong></p>
<pre><code class="lang-bash">gitbook <span class="hljs-built_in">help</span>
</code></pre>
<p><strong>&#x8F93;&#x51FA; gitbook-cli &#x7684;&#x5E2E;&#x52A9;&#x4FE1;&#x606F;</strong></p>
<pre><code class="lang-bash">gitbook --help
</code></pre>
<p><strong>&#x751F;&#x6210;&#x9759;&#x6001;&#x7F51;&#x9875;</strong></p>
<pre><code class="lang-bash">gitbook build
</code></pre>
<p><strong>&#x751F;&#x6210;&#x9759;&#x6001;&#x7F51;&#x9875;&#x5E76;&#x8FD0;&#x884C;&#x670D;&#x52A1;&#x5668;</strong></p>
<pre><code class="lang-bash">gitbook serve
</code></pre>
<p><strong>&#x751F;&#x6210;&#x65F6;&#x6307;&#x5B9A;gitbook&#x7684;&#x7248;&#x672C;, &#x672C;&#x5730;&#x6CA1;&#x6709;&#x4F1A;&#x5148;&#x4E0B;&#x8F7D;</strong></p>
<pre><code class="lang-bash">gitbook build --gitbook=2.0.1
</code></pre>
<p><strong>&#x5217;&#x51FA;&#x672C;&#x5730;&#x6240;&#x6709;&#x7684;gitbook&#x7248;&#x672C;</strong></p>
<pre><code class="lang-bash">gitbook ls
</code></pre>
<p><strong>&#x5217;&#x51FA;&#x8FDC;&#x7A0B;&#x53EF;&#x7528;&#x7684;gitbook&#x7248;&#x672C;</strong></p>
<pre><code class="lang-bash">gitbook ls-remote
</code></pre>
<p><strong>&#x5B89;&#x88C5;&#x5BF9;&#x5E94;&#x7684;gitbook&#x7248;&#x672C;</strong></p>
<pre><code class="lang-bash">gitbook fetch &#x6807;&#x7B7E;/&#x7248;&#x672C;&#x53F7;
</code></pre>
<p><strong>&#x66F4;&#x65B0;&#x5230;gitbook&#x7684;&#x6700;&#x65B0;&#x7248;&#x672C;</strong></p>
<pre><code class="lang-bash">gitbook update
</code></pre>
<p><strong>&#x5378;&#x8F7D;&#x5BF9;&#x5E94;&#x7684;gitbook&#x7248;&#x672C;</strong></p>
<pre><code class="lang-bash">gitbook uninstall 2.0.1
</code></pre>
<p><strong>&#x6307;&#x5B9A;log&#x7684;&#x7EA7;&#x522B;</strong></p>
<pre><code class="lang-bash">gitbook build --log=debug
</code></pre>
<p><strong>&#x8F93;&#x51FA;&#x9519;&#x8BEF;&#x4FE1;&#x606F;</strong></p>
<pre><code class="lang-bash">gitbook builid --debug
</code></pre>
<p>Gitbook &#x76EE;&#x5F55;&#x7ED3;&#x6784;</p>
<h3 id="gitbook-&#x9879;&#x76EE;&#x7ED3;&#x6784;">GitBook &#x9879;&#x76EE;&#x7ED3;&#x6784;</h3>
<p>GitBook&#x4F7F;&#x7528;&#x7B80;&#x5355;&#x7684;&#x76EE;&#x5F55;&#x7ED3;&#x6784;&#x3002;&#x5728; <a href="https://toolchain.gitbook.com/pages.html" target="_blank">SUMMARY</a> &#xFF08;&#x5373; <code>SUMMARY.md</code> &#x6587;&#x4EF6;&#xFF09;&#x4E2D;&#x5217;&#x51FA;&#x7684;&#x6240;&#x6709; Markdown / Asciidoc &#x6587;&#x4EF6;&#x5C06;&#x88AB;&#x8F6C;&#x6362;&#x4E3A; HTML&#x3002;&#x591A;&#x8BED;&#x8A00;&#x4E66;&#x7C4D;&#x7ED3;&#x6784;&#x7565;&#x6709;&#x4E0D;&#x540C;&#x3002;</p>
<p>&#x4E00;&#x4E2A;&#x57FA;&#x672C;&#x7684; GitBook &#x7535;&#x5B50;&#x4E66;&#x7ED3;&#x6784;&#x901A;&#x5E38;&#x5982;&#x4E0B;&#xFF1A;</p>
<pre><code>.
&#x251C;&#x2500;&#x2500; book.json
&#x251C;&#x2500;&#x2500; README.md
&#x251C;&#x2500;&#x2500; SUMMARY.md
&#x251C;&#x2500;&#x2500; chapter-1/
|   &#x251C;&#x2500;&#x2500; README.md
|   &#x2514;&#x2500;&#x2500; something.md
&#x2514;&#x2500;&#x2500; chapter-2/
    &#x251C;&#x2500;&#x2500; README.md
    &#x2514;&#x2500;&#x2500; something.md
</code></pre><p>GitBook &#x7279;&#x6B8A;&#x6587;&#x4EF6;&#x7684;&#x529F;&#x80FD;&#xFF1A;</p>
<table>
<thead>
<tr>
<th style="text-align:left">&#x6587;&#x4EF6;</th>
<th style="text-align:left">&#x63CF;&#x8FF0;</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>book.json</code></td>
<td style="text-align:left">&#x914D;&#x7F6E;&#x6570;&#x636E; (<strong>optional</strong>)</td>
</tr>
<tr>
<td style="text-align:left"><code>README.md</code></td>
<td style="text-align:left">&#x7535;&#x5B50;&#x4E66;&#x7684;&#x524D;&#x8A00;&#x6216;&#x7B80;&#x4ECB; (<strong>required</strong>)</td>
</tr>
<tr>
<td style="text-align:left"><code>SUMMARY.md</code></td>
<td style="text-align:left">&#x7535;&#x5B50;&#x4E66;&#x76EE;&#x5F55; (<strong>optional</strong>)</td>
</tr>
<tr>
<td style="text-align:left"><code>GLOSSARY.md</code></td>
<td style="text-align:left">&#x8BCD;&#x6C47;/&#x6CE8;&#x91CA;&#x672F;&#x8BED;&#x5217;&#x8868; (<strong>optional</strong>)</td>
</tr>
</tbody>
</table>
<h4 id="&#x9759;&#x6001;&#x6587;&#x4EF6;&#x548C;&#x56FE;&#x7247;">&#x9759;&#x6001;&#x6587;&#x4EF6;&#x548C;&#x56FE;&#x7247;</h4>
<p>&#x9759;&#x6001;&#x6587;&#x4EF6;&#x662F;&#x5728; <code>SUMMARY.md</code> &#x4E2D;&#x672A;&#x5217;&#x51FA;&#x7684;&#x6587;&#x4EF6;&#x3002;&#x9664;&#x975E;&#x88AB;&#x5FFD;&#x7565;&#xFF0C;&#x5426;&#x5219;&#x6240;&#x6709;&#x9759;&#x6001;&#x6587;&#x4EF6;&#x90FD;&#x5C06;&#x590D;&#x5236;&#x5230;&#x8F93;&#x51FA;&#x8DEF;&#x5F84;&#x3002;</p>
<h4 id="&#x5FFD;&#x7565;&#x6587;&#x4EF6;&#x548C;&#x6587;&#x4EF6;&#x5939;">&#x5FFD;&#x7565;&#x6587;&#x4EF6;&#x548C;&#x6587;&#x4EF6;&#x5939;</h4>
<p>GitBook&#x5C06;&#x8BFB;&#x53D6; <code>.gitignore</code>&#xFF0C;<code>.bookignore</code> &#x548C; <code>.ignore</code> &#x6587;&#x4EF6;&#xFF0C;&#x4EE5;&#x83B7;&#x53D6;&#x8981;&#x8FC7;&#x6EE4;&#x7684;&#x6587;&#x4EF6;&#x548C;&#x6587;&#x4EF6;&#x5939;&#x3002;&#x8FD9;&#x4E9B;&#x6587;&#x4EF6;&#x4E2D;&#x7684;&#x683C;&#x5F0F;&#x9075;&#x5FAA; <code>.gitignore</code> &#x7684;&#x89C4;&#x5219;&#xFF1A;</p>
<pre><code># This is a comment

# Ignore the file test.md
test.md

# Ignore everything in the directory &quot;bin&quot;
bin/*
</code></pre><h4 id="&#x9879;&#x76EE;&#x4E0E;&#x5B50;&#x76EE;&#x5F55;&#x96C6;&#x6210;">&#x9879;&#x76EE;&#x4E0E;&#x5B50;&#x76EE;&#x5F55;&#x96C6;&#x6210;</h4>
<p>&#x5BF9;&#x4E8E;&#x8F6F;&#x4EF6;&#x9879;&#x76EE;&#xFF0C;&#x60A8;&#x53EF;&#x4EE5;&#x4F7F;&#x7528;&#x5B50;&#x76EE;&#x5F55;&#xFF08;&#x5982; <code>docs/</code> &#xFF09;&#x6765;&#x5B58;&#x50A8;&#x9879;&#x76EE;&#x6587;&#x6863;&#x7684;&#x56FE;&#x4E66;&#x3002;&#x60A8;&#x53EF;&#x4EE5;&#x914D;&#x7F6E;&#x6839;&#x9009;&#x9879;&#x6765;&#x6307;&#x793A; GitBook &#x53EF;&#x4EE5;&#x627E;&#x5230;&#x8BE5;&#x56FE;&#x4E66;&#x6587;&#x4EF6;&#x7684;&#x6587;&#x4EF6;&#x5939;&#xFF1A;</p>
<pre><code>.
&#x251C;&#x2500;&#x2500; book.json
&#x2514;&#x2500;&#x2500; docs/
    &#x251C;&#x2500;&#x2500; README.md
    &#x2514;&#x2500;&#x2500; SUMMARY.md
</code></pre><p>&#x5728; <code>book.json</code> &#x4E2D;&#x914D;&#x7F6E;&#x4EE5;&#x4E0B;&#x5185;&#x5BB9;&#xFF1A;</p>
<pre><code class="lang-json">{
    <span class="hljs-string">&quot;root&quot;</span>: <span class="hljs-string">&quot;./docs&quot;</span>
}
</code></pre>
<h3 id="summary">Summary</h3>
<p>GitBook &#x4F7F;&#x7528; <code>SUMMARY.md</code> &#x6587;&#x4EF6;&#x6765;&#x5B9A;&#x4E49;&#x672C;&#x4E66;&#x7684;&#x7AE0;&#x8282;&#x548C;&#x5B50;&#x7AE0;&#x8282;&#x7684;&#x7ED3;&#x6784;&#x3002; <code>SUMMARY.md</code>&#x6587;&#x4EF6;&#x7528;&#x4E8E;&#x751F;&#x6210;&#x672C;&#x4E66;&#x7684;&#x76EE;&#x5F55;&#x3002;</p>
<p><code>SUMMARY.md</code> &#x7684;&#x683C;&#x5F0F;&#x662F;&#x4E00;&#x4E2A;&#x94FE;&#x63A5;&#x5217;&#x8868;&#x3002;&#x94FE;&#x63A5;&#x7684;&#x6807;&#x9898;&#x5C06;&#x4F5C;&#x4E3A;&#x7AE0;&#x8282;&#x7684;&#x6807;&#x9898;&#xFF0C;&#x94FE;&#x63A5;&#x7684;&#x76EE;&#x6807;&#x662F;&#x8BE5;&#x7AE0;&#x8282;&#x6587;&#x4EF6;&#x7684;&#x8DEF;&#x5F84;&#x3002;</p>
<p>&#x5411;&#x7236;&#x7AE0;&#x8282;&#x6DFB;&#x52A0;&#x5D4C;&#x5957;&#x5217;&#x8868;&#x5C06;&#x521B;&#x5EFA;&#x5B50;&#x7AE0;&#x8282;&#x3002;</p>
<p><strong>&#x7B80;&#x5355;&#x793A;&#x4F8B;&#xFF1A;</strong></p>
<pre><code># Summary

* [Part I](part1/README.md)
    * [Writing is nice](part1/writing.md)
    * [GitBook is nice](part1/gitbook.md)
* [Part II](part2/README.md)
    * [We love feedback](part2/feedback_please.md)
    * [Better tools for authors](part2/better_tools.md)
</code></pre><p>&#x6BCF;&#x7AE0;&#x90FD;&#x6709;&#x4E00;&#x4E2A;&#x4E13;&#x7528;&#x9875;&#x9762;&#xFF08;<code>part#/README.md</code>&#xFF09;&#xFF0C;&#x5E76;&#x5206;&#x4E3A;&#x5B50;&#x7AE0;&#x8282;&#x3002;</p>
<p><strong>&#x951A;&#x70B9;</strong></p>
<p>&#x76EE;&#x5F55;&#x4E2D;&#x7684;&#x7AE0;&#x8282;&#x53EF;&#x4EE5;&#x4F7F;&#x7528;&#x951A;&#x70B9;&#x6307;&#x5411;&#x6587;&#x4EF6;&#x7684;&#x7279;&#x5B9A;&#x90E8;&#x5206;&#x3002;</p>
<pre><code># Summary

### Part I

* [Part I](part1/README.md)
    * [Writing is nice](part1/README.md#writing)
    * [GitBook is nice](part1/README.md#gitbook)
* [Part II](part2/README.md)
    * [We love feedback](part2/README.md#feedback)
    * [Better tools for authors](part2/README.md#tools)
</code></pre><p><strong>&#x90E8;&#x5206;</strong></p>
<p>&#x76EE;&#x5F55;&#x53EF;&#x4EE5;&#x5206;&#x4E3A;&#x4EE5;&#x6807;&#x9898;&#x6216;&#x6C34;&#x5E73;&#x7EBF; <code>----</code> &#x5206;&#x9694;&#x7684;&#x90E8;&#x5206;&#xFF1A;</p>
<pre><code># Summary

### Part I

* [Writing is nice](part1/writing.md)
* [GitBook is nice](part1/gitbook.md)

### Part II

* [We love feedback](part2/feedback_please.md)
* [Better tools for authors](part2/better_tools.md)

----

* [Last part without title](part3/title.md)
</code></pre><p>Parts &#x53EA;&#x662F;&#x7AE0;&#x8282;&#x7EC4;&#xFF0C;&#x6CA1;&#x6709;&#x4E13;&#x7528;&#x9875;&#x9762;&#xFF0C;&#x4F46;&#x6839;&#x636E;&#x4E3B;&#x9898;&#xFF0C;&#x5B83;&#x5C06;&#x5728;&#x5BFC;&#x822A;&#x4E2D;&#x663E;&#x793A;&#x3002;</p>
<h4 id="&#x9875;&#x9762;">&#x9875;&#x9762;</h4>
<p><strong>Markdown &#x8BED;&#x6CD5;</strong></p>
<p>&#x9ED8;&#x8BA4;&#x60C5;&#x51B5;&#x4E0B;&#xFF0C;GitBook &#x7684;&#x5927;&#x591A;&#x6570;&#x6587;&#x4EF6;&#x90FD;&#x4F7F;&#x7528; Markdown &#x8BED;&#x6CD5;&#x3002; GitBook &#x63A8;&#x8350;&#x4F7F;&#x7528;&#x8FD9;&#x79CD;&#x8BED;&#x6CD5;&#x3002;&#x6240;&#x4F7F;&#x7528;&#x7684;&#x8BED;&#x6CD5;&#x7C7B;&#x4F3C;&#x4E8E; <a href="https://guides.github.com/features/mastering-markdown/" target="_blank">GitHub Flavored Markdown syntax</a> &#x3002;</p>
<p>&#x6B64;&#x5916;&#xFF0C;&#x4F60;&#x8FD8;&#x53EF;&#x4EE5;&#x9009;&#x62E9; <a href="https://toolchain.gitbook.com/syntax/asciidoc.html" target="_blank">AsciiDoc &#x8BED;&#x6CD5;</a>&#x3002;</p>
<p><strong>&#x9875;&#x9762;&#x5185;&#x5BB9;&#x793A;&#x4F8B;&#xFF1A;</strong></p>
<pre><code># Title of the chapter

This is a great introduction.

## Section 1

Markdown will dictates _most_ of your **book&apos;s structure**

## Section 2

...
</code></pre><p><strong>&#x9875;&#x9762;&#x524D;&#x8A00;</strong></p>
<p>&#x9875;&#x9762;&#x53EF;&#x4EE5;&#x5305;&#x542B;&#x4E00;&#x4E2A;&#x53EF;&#x9009;&#x7684;&#x524D;&#x8A00;&#x3002;&#x5B83;&#x53EF;&#x4EE5;&#x7528;&#x4E8E;&#x5B9A;&#x4E49;&#x9875;&#x9762;&#x7684;&#x63CF;&#x8FF0;&#x3002;&#x524D;&#x9762;&#x7684;&#x4E8B;&#x60C5;&#x5FC5;&#x987B;&#x662F;&#x6587;&#x4EF6;&#x4E2D;&#x7684;&#x7B2C;&#x4E00;&#x4EF6;&#x4E8B;&#xFF0C;&#x5FC5;&#x987B;&#x91C7;&#x53D6;&#x5728;&#x4E09;&#x865A;&#x7EBF;&#x4E4B;&#x95F4;&#x8BBE;&#x7F6E;&#x7684;&#x6709;&#x6548;YAML&#x7684;&#x5F62;&#x5F0F;&#x3002;&#x8FD9;&#x662F;&#x4E00;&#x4E2A;&#x57FA;&#x672C;&#x7684;&#x4F8B;&#x5B50;&#xFF1A;</p>
<pre><code>---
description: This is a short description of my page
---

# The content of my page
...
</code></pre><h3 id="glossary">Glossary</h3>
<p>&#x5141;&#x8BB8;&#x60A8;&#x6307;&#x5B9A;&#x8981;&#x663E;&#x793A;&#x4E3A;&#x6CE8;&#x91CA;&#x7684;&#x672F;&#x8BED;&#x53CA;&#x5176;&#x5404;&#x81EA;&#x7684;&#x5B9A;&#x4E49;&#x3002;&#x6839;&#x636E;&#x8FD9;&#x4E9B;&#x672F;&#x8BED;&#xFF0C;GitBook &#x5C06;&#x81EA;&#x52A8;&#x6784;&#x5EFA;&#x7D22;&#x5F15;&#x5E76;&#x7A81;&#x51FA;&#x663E;&#x793A;&#x8FD9;&#x4E9B;&#x672F;&#x8BED;&#x3002;</p>
<p><code>GLOSSARY.md</code> &#x7684;&#x683C;&#x5F0F;&#x662F; <code>h2</code> &#x6807;&#x9898;&#x7684;&#x5217;&#x8868;&#xFF0C;&#x4EE5;&#x53CA;&#x63CF;&#x8FF0;&#x6BB5;&#x843D;&#xFF1A;</p>
<pre><code>## Term
Definition for this term

## Another term
With it&apos;s definition, this can contain bold text
and all other kinds of inline markup ...
</code></pre><p>Gitbook &#x914D;&#x7F6E;</p>
<blockquote>
<p>GitBook &#x5141;&#x8BB8;&#x60A8;&#x4F7F;&#x7528;&#x7075;&#x6D3B;&#x7684;&#x914D;&#x7F6E;&#x81EA;&#x5B9A;&#x4E49;&#x60A8;&#x7684;&#x7535;&#x5B50;&#x4E66;&#x3002;</p>
<p>&#x8FD9;&#x4E9B;&#x9009;&#x9879;&#x5728; <code>book.json</code> &#x6587;&#x4EF6;&#x4E2D;&#x6307;&#x5B9A;&#x3002;&#x5BF9;&#x4E8E;&#x4E0D;&#x719F;&#x6089; JSON &#x8BED;&#x6CD5;&#x7684;&#x4F5C;&#x8005;&#xFF0C;&#x60A8;&#x53EF;&#x4EE5;&#x4F7F;&#x7528; <a href="http://jsonlint.com/" target="_blank">JSONlint</a> &#x7B49;&#x5DE5;&#x5177;&#x9A8C;&#x8BC1;&#x8BED;&#x6CD5;&#x3002;</p>
</blockquote>
<h3 id="&#x5E38;&#x89C4;&#x8BBE;&#x7F6E;">&#x5E38;&#x89C4;&#x8BBE;&#x7F6E;</h3>
<table>
<thead>
<tr>
<th style="text-align:left">&#x53D8;&#x91CF;</th>
<th style="text-align:left">&#x63CF;&#x8FF0;</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>root</code></td>
<td style="text-align:left">&#x5305;&#x542B;&#x6240;&#x6709;&#x56FE;&#x4E66;&#x6587;&#x4EF6;&#x7684;&#x6839;&#x6587;&#x4EF6;&#x5939;&#x7684;&#x8DEF;&#x5F84;&#xFF0C;&#x9664;&#x4E86; <code>book.json</code></td>
</tr>
<tr>
<td style="text-align:left"><code>structure</code></td>
<td style="text-align:left">&#x6307;&#x5B9A;&#x81EA;&#x8FF0;&#x6587;&#x4EF6;&#xFF0C;&#x6458;&#x8981;&#xFF0C;&#x8BCD;&#x6C47;&#x8868;&#x7B49;&#x7684;&#x8DEF;&#x5F84;&#xFF0C;&#x53C2;&#x8003; <a href="https://www.imooc.com/article/22889#structure" target="_blank">Structure paragraph</a>.</td>
</tr>
<tr>
<td style="text-align:left"><code>title</code></td>
<td style="text-align:left">&#x60A8;&#x7684;&#x4E66;&#x540D;&#xFF0C;&#x9ED8;&#x8BA4;&#x503C;&#x662F;&#x4ECE; README &#x4E2D;&#x63D0;&#x53D6;&#x51FA;&#x6765;&#x7684;&#x3002;&#x5728; GitBook.com &#x4E0A;&#xFF0C;&#x8FD9;&#x4E2A;&#x5B57;&#x6BB5;&#x662F;&#x9884;&#x586B;&#x7684;&#x3002;</td>
</tr>
<tr>
<td style="text-align:left"><code>description</code></td>
<td style="text-align:left">&#x60A8;&#x7684;&#x4E66;&#x7C4D;&#x7684;&#x63CF;&#x8FF0;&#xFF0C;&#x9ED8;&#x8BA4;&#x503C;&#x662F;&#x4ECE; README &#x4E2D;&#x63D0;&#x53D6;&#x51FA;&#x6765;&#x7684;&#x3002;&#x5728; GitBook.com &#x4E0A;&#xFF0C;&#x8FD9;&#x4E2A;&#x5B57;&#x6BB5;&#x662F;&#x9884;&#x586B;&#x7684;&#x3002;</td>
</tr>
<tr>
<td style="text-align:left"><code>author</code></td>
<td style="text-align:left">&#x4F5C;&#x8005;&#x540D;&#x3002;&#x5728;GitBook.com&#x4E0A;&#xFF0C;&#x8FD9;&#x4E2A;&#x5B57;&#x6BB5;&#x662F;&#x9884;&#x586B;&#x7684;&#x3002;</td>
</tr>
<tr>
<td style="text-align:left"><code>isbn</code></td>
<td style="text-align:left">&#x56FD;&#x9645;&#x6807;&#x51C6;&#x4E66;&#x53F7; ISBN</td>
</tr>
<tr>
<td style="text-align:left"><code>language</code></td>
<td style="text-align:left">&#x672C;&#x4E66;&#x7684;&#x8BED;&#x8A00;&#x7C7B;&#x578B; &#x2014;&#x2014; <a href="https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes" target="_blank">ISO code</a> &#x3002;&#x9ED8;&#x8BA4;&#x503C;&#x662F; <code>en</code></td>
</tr>
<tr>
<td style="text-align:left"><code>direction</code></td>
<td style="text-align:left">&#x6587;&#x672C;&#x9605;&#x8BFB;&#x987A;&#x5E8F;&#x3002;&#x53EF;&#x4EE5;&#x662F; <code>rtl</code> &#xFF08;&#x4ECE;&#x53F3;&#x5411;&#x5DE6;&#xFF09;&#x6216; <code>ltr</code> &#xFF08;&#x4ECE;&#x5DE6;&#x5411;&#x53F3;&#xFF09;&#xFF0C;&#x9ED8;&#x8BA4;&#x503C;&#x4F9D;&#x8D56;&#x4E8E; <code>language</code> &#x7684;&#x503C;&#x3002;</td>
</tr>
<tr>
<td style="text-align:left"><code>gitbook</code></td>
<td style="text-align:left">&#x5E94;&#x8BE5;&#x4F7F;&#x7528;&#x7684;GitBook&#x7248;&#x672C;&#x3002;&#x4F7F;&#x7528; <a href="http://semver.org/" target="_blank">SemVer</a> &#x89C4;&#x8303;&#xFF0C;&#x5E76;&#x63A5;&#x53D7;&#x7C7B;&#x4F3C;&#x4E8E; <code>&#x201C;&gt; = 3.0.0&#x201D;</code> &#x7684;&#x6761;&#x4EF6;&#x3002;</td>
</tr>
</tbody>
</table>
<p>author</p>
<p>&#x4F5C;&#x8005;&#x59D3;&#x540D;&#xFF0C;&#x5728;GitBook.com&#x4E0A;&#xFF0C;&#x8FD9;&#x4E2A;&#x5B57;&#x6BB5;&#x662F;&#x9884;&#x5148;&#x586B;&#x5199;&#x7684;&#x3002;</p>
<p>&#x4F8B;&#xFF1A;</p>
<pre><code class="lang-json"><span class="hljs-string">&quot;author&quot;</span> : <span class="hljs-string">&quot;victor zhang&quot;</span>
</code></pre>
<p>description</p>
<p>&#x7535;&#x5B50;&#x4E66;&#x7684;&#x63CF;&#x8FF0;&#xFF0C;&#x9ED8;&#x8BA4;&#x503C;&#x662F;&#x4ECE; README &#x4E2D;&#x63D0;&#x53D6;&#x51FA;&#x6765;&#x7684;&#x3002;&#x5728;GitBook.com&#x4E0A;&#xFF0C;&#x8FD9;&#x4E2A;&#x5B57;&#x6BB5;&#x662F;&#x9884;&#x5148;&#x586B;&#x5199;&#x7684;&#x3002;</p>
<p>&#x4F8B;&#xFF1A;</p>
<pre><code class="lang-json"><span class="hljs-string">&quot;description&quot;</span> : <span class="hljs-string">&quot;Gitbook &#x6559;&#x7A0B;&quot;</span>
</code></pre>
<p>direction</p>
<p>&#x6587;&#x672C;&#x7684;&#x65B9;&#x5411;&#x3002;&#x53EF;&#x4EE5;&#x662F; rtl &#x6216; ltr&#xFF0C;&#x9ED8;&#x8BA4;&#x503C;&#x53D6;&#x51B3;&#x4E8E;&#x8BED;&#x8A00;&#x7684;&#x503C;&#x3002;</p>
<p>&#x4F8B;&#xFF1A;</p>
<pre><code class="lang-json"><span class="hljs-string">&quot;direction&quot;</span> : <span class="hljs-string">&quot;ltr&quot;</span>
</code></pre>
<p>gitbook</p>
<p>&#x5E94;&#x8BE5;&#x4F7F;&#x7528;&#x7684;GitBook&#x7248;&#x672C;&#x3002;&#x4F7F;&#x7528;SemVer&#x89C4;&#x8303;&#xFF0C;&#x63A5;&#x53D7;&#x7C7B;&#x4F3C;&#x4E8E; &gt;=3.0.0 &#x7684;&#x6761;&#x4EF6;&#x3002;</p>
<p>&#x4F8B;&#xFF1A;</p>
<pre><code class="lang-json"><span class="hljs-string">&quot;gitbook&quot;</span> : <span class="hljs-string">&quot;3.0.0&quot;</span>,
<span class="hljs-string">&quot;gitbook&quot;</span> : <span class="hljs-string">&quot;&gt;=3.0.0&quot;</span>
</code></pre>
<p>language</p>
<p>Gitbook&#x4F7F;&#x7528;&#x7684;&#x8BED;&#x8A00;, &#x7248;&#x672C;2.6.4&#x4E2D;&#x53EF;&#x9009;&#x7684;&#x8BED;&#x8A00;&#x5982;&#x4E0B;&#xFF1A;</p>
<pre><code>en, ar, bn, cs, de, en, es, fa, fi, fr, he, it, ja, ko, no, pl, pt, ro, ru, sv, uk, vi, zh-hans, zh-tw
</code></pre><p>&#x4F8B;&#xFF1A;</p>
<pre><code class="lang-json"><span class="hljs-string">&quot;language&quot;</span> : <span class="hljs-string">&quot;zh-hans&quot;</span>,
</code></pre>
<p>links</p>
<p>&#x5728;&#x5DE6;&#x4FA7;&#x5BFC;&#x822A;&#x680F;&#x6DFB;&#x52A0;&#x94FE;&#x63A5;&#x4FE1;&#x606F;</p>
<p>&#x4F8B;&#xFF1A;</p>
<pre><code class="lang-json"><span class="hljs-string">&quot;links&quot;</span> : {
    <span class="hljs-string">&quot;sidebar&quot;</span> : {
        <span class="hljs-string">&quot;Home&quot;</span> : <span class="hljs-string">&quot;https://github.com/dunwu/gitbook-notes&quot;</span>
    }
}
</code></pre>
<p>root</p>
<p>&#x5305;&#x542B;&#x6240;&#x6709;&#x56FE;&#x4E66;&#x6587;&#x4EF6;&#x7684;&#x6839;&#x6587;&#x4EF6;&#x5939;&#x7684;&#x8DEF;&#x5F84;&#xFF0C; book.json &#x6587;&#x4EF6;&#x9664;&#x5916;&#x3002;</p>
<p>&#x4F8B;&#xFF1A;</p>
<pre><code class="lang-json"><span class="hljs-string">&quot;root&quot;</span> : <span class="hljs-string">&quot;./docs&quot;</span>,
</code></pre>
<p>structure</p>
<p>&#x6307;&#x5B9A; Readme&#x3001;Summary&#x3001;Glossary &#x548C; Languages &#x5BF9;&#x5E94;&#x7684;&#x6587;&#x4EF6;&#x540D;&#x3002;</p>
<p>styles</p>
<p>&#x81EA;&#x5B9A;&#x4E49;&#x9875;&#x9762;&#x6837;&#x5F0F;&#xFF0C; &#x9ED8;&#x8BA4;&#x60C5;&#x51B5;&#x4E0B;&#x5404;generator&#x5BF9;&#x5E94;&#x7684;css&#x6587;&#x4EF6;</p>
<p>&#x4F8B;&#xFF1A;</p>
<pre><code class="lang-json"><span class="hljs-string">&quot;styles&quot;</span>: {
    <span class="hljs-string">&quot;website&quot;</span>: <span class="hljs-string">&quot;styles/website.css&quot;</span>,
    <span class="hljs-string">&quot;ebook&quot;</span>: <span class="hljs-string">&quot;styles/ebook.css&quot;</span>,
    <span class="hljs-string">&quot;pdf&quot;</span>: <span class="hljs-string">&quot;styles/pdf.css&quot;</span>,
    <span class="hljs-string">&quot;mobi&quot;</span>: <span class="hljs-string">&quot;styles/mobi.css&quot;</span>,
    <span class="hljs-string">&quot;epub&quot;</span>: <span class="hljs-string">&quot;styles/epub.css&quot;</span>
}
</code></pre>
<p>&#x4F8B;&#x5982;&#x8981;&#x4F7F; <code>h1</code>&#x3001;<code>h2</code> &#x6807;&#x7B7E;&#x6709;&#x4E0B;&#x8FB9;&#x6846;&#xFF0C; &#x53EF;&#x4EE5;&#x5728; <code>website.css</code> &#x4E2D;&#x8BBE;&#x7F6E;</p>
<pre><code class="lang-css"><span class="hljs-selector-tag">h1</span> , <span class="hljs-selector-tag">h2</span>{
    <span class="hljs-attribute">border-bottom</span>: <span class="hljs-number">1px</span> solid <span class="hljs-number">#EFEAEA</span>;
}
</code></pre>
<p>title</p>
<p>&#x7535;&#x5B50;&#x4E66;&#x7684;&#x4E66;&#x540D;&#xFF0C;&#x9ED8;&#x8BA4;&#x503C;&#x662F;&#x4ECE; README &#x4E2D;&#x63D0;&#x53D6;&#x51FA;&#x6765;&#x7684;&#x3002;&#x5728; GitBook.com &#x4E0A;&#xFF0C;&#x8FD9;&#x4E2A;&#x5B57;&#x6BB5;&#x662F;&#x9884;&#x5148;&#x586B;&#x5199;&#x7684;&#x3002;</p>
<p>&#x4F8B;&#xFF1A;</p>
<pre><code class="lang-json"><span class="hljs-string">&quot;title&quot;</span> : <span class="hljs-string">&quot;gitbook-notes&quot;</span>,
</code></pre>
<h3 id="plugins">plugins</h3>
<p>&#x63D2;&#x4EF6;&#x53CA;&#x5176;&#x914D;&#x7F6E;&#x5728; <code>book.json</code> &#x4E2D;&#x6307;&#x5B9A;&#x3002;&#x6709;&#x5173;&#x8BE6;&#x7EC6;&#x4FE1;&#x606F;&#x3002;</p>
<p>&#x81EA; 3.0.0 &#x7248;&#x672C;&#x5F00;&#x59CB;&#xFF0C;GitBook &#x53EF;&#x4EE5;&#x4F7F;&#x7528;&#x4E3B;&#x9898;&#x3002;&#x6709;&#x5173;&#x8BE6;&#x7EC6;&#x4FE1;&#x606F;&#xFF0C;&#x8BF7;&#x53C2;&#x9605;  <a href="https://toolchain.gitbook.com/themes/" target="_blank">the theming section</a> &#x3002;</p>
<table>
<thead>
<tr>
<th style="text-align:left">&#x53D8;&#x91CF;</th>
<th style="text-align:left">&#x63CF;&#x8FF0;</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>plugins</code></td>
<td style="text-align:left">&#x8981;&#x52A0;&#x8F7D;&#x7684;&#x63D2;&#x4EF6;&#x5217;&#x8868;</td>
</tr>
<tr>
<td style="text-align:left"><code>pluginsConfig</code></td>
<td style="text-align:left">&#x63D2;&#x4EF6;&#x7684;&#x914D;&#x7F6E;</td>
</tr>
</tbody>
</table>
<h4 id="&#x6DFB;&#x52A0;&#x63D2;&#x4EF6;">&#x6DFB;&#x52A0;&#x63D2;&#x4EF6;</h4>
<pre><code class="lang-json"><span class="hljs-string">&quot;plugins&quot;</span>: [
    <span class="hljs-string">&quot;splitter&quot;</span>
]
</code></pre>
<p>&#x6DFB;&#x52A0;&#x65B0;&#x63D2;&#x4EF6;&#x4E4B;&#x540E;&#x9700;&#x8981;&#x8FD0;&#x884C; <code>gitbook install</code> &#x6765;&#x5B89;&#x88C5;&#x65B0;&#x7684;&#x63D2;&#x4EF6;</p>
<h3 id="&#x53BB;&#x9664;&#x81EA;&#x5E26;&#x63D2;&#x4EF6;">&#x53BB;&#x9664;&#x81EA;&#x5E26;&#x63D2;&#x4EF6;</h3>
<p>Gitbook &#x9ED8;&#x8BA4;&#x5E26;&#x6709; 5 &#x4E2A;&#x63D2;&#x4EF6;&#xFF1A;</p>
<ul>
<li>highlight</li>
<li>search</li>
<li>sharing</li>
<li>font-settings</li>
<li>livereload</li>
</ul>
<pre><code class="lang-json"><span class="hljs-string">&quot;plugins&quot;</span>: [
    <span class="hljs-string">&quot;-search&quot;</span>
]
</code></pre>
<h3 id="structure">structure</h3>
<p>&#x9664;&#x4E86; <code>root</code> &#x5C5E;&#x6027;&#x4E4B;&#x5916;&#xFF0C;&#x60A8;&#x53EF;&#x4EE5;&#x6307;&#x5B9A; Readme&#xFF0C;Summary&#xFF0C;Glossary &#x548C; Languages &#x7684;&#x540D;&#x79F0;&#xFF08;&#x800C;&#x4E0D;&#x662F;&#x4F7F;&#x7528;&#x9ED8;&#x8BA4;&#x540D;&#x79F0;&#xFF0C;&#x5982;README.md&#xFF09;&#x3002;&#x8FD9;&#x4E9B;&#x6587;&#x4EF6;&#x5FC5;&#x987B;&#x5728;&#x9879;&#x76EE;&#x7684;&#x6839;&#x76EE;&#x5F55;&#x4E0B;&#xFF08;&#x6216; <code>root</code> &#x7684;&#x6839;&#x76EE;&#x5F55;&#xFF0C;&#x5982;&#x679C;&#x4F60;&#x5728; <code>book.json</code> &#x4E2D;&#x914D;&#x7F6E;&#x4E86; <code>root</code> &#x5C5E;&#x6027;&#xFF09;&#x3002;&#x4E0D;&#x63A5;&#x53D7;&#x7684;&#x8DEF;&#x5F84;&#xFF0C;&#x5982;&#xFF1A;<code>dir / MY_README.md</code>&#x3002;</p>
<table>
<thead>
<tr>
<th style="text-align:left">&#x53D8;&#x91CF;</th>
<th style="text-align:left">&#x63CF;&#x8FF0;</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>structure.readme</code></td>
<td style="text-align:left">Readme &#x6587;&#x4EF6;&#x540D;&#xFF08;&#x9ED8;&#x8BA4;&#x503C;&#x662F;  <code>README.md</code> &#xFF09;</td>
</tr>
<tr>
<td style="text-align:left"><code>structure.summary</code></td>
<td style="text-align:left">Summary &#x6587;&#x4EF6;&#x540D;&#xFF08;&#x9ED8;&#x8BA4;&#x503C;&#x662F; <code>SUMMARY.md</code> &#xFF09;</td>
</tr>
<tr>
<td style="text-align:left"><code>structure.glossary</code></td>
<td style="text-align:left">Glossary &#x6587;&#x4EF6;&#x540D;&#xFF08;&#x9ED8;&#x8BA4;&#x503C;&#x662F; <code>GLOSSARY.md</code> &#xFF09;</td>
</tr>
<tr>
<td style="text-align:left"><code>structure.languages</code></td>
<td style="text-align:left">Languages &#x6587;&#x4EF6;&#x540D;&#xFF08;&#x9ED8;&#x8BA4;&#x503C;&#x662F; <code>LANGS.md</code> &#xFF09;</td>
</tr>
</tbody>
</table>
<h3 id="pdf">pdf</h3>
<p>&#x53EF;&#x4EE5;&#x4F7F;&#x7528; <code>book.json</code> &#x4E2D;&#x7684;&#x4E00;&#x7EC4;&#x9009;&#x9879;&#x6765;&#x5B9A;&#x5236;PDF&#x8F93;&#x51FA;&#xFF1A;</p>
<table>
<thead>
<tr>
<th style="text-align:left">Variable</th>
<th style="text-align:left">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>pdf.pageNumbers</code></td>
<td style="text-align:left">&#x5C06;&#x9875;&#x7801;&#x6DFB;&#x52A0;&#x5230;&#x6BCF;&#x4E2A;&#x9875;&#x9762;&#x7684;&#x5E95;&#x90E8;&#xFF08;&#x9ED8;&#x8BA4;&#x4E3A; true&#xFF09;</td>
</tr>
<tr>
<td style="text-align:left"><code>pdf.fontSize</code></td>
<td style="text-align:left">&#x57FA;&#x672C;&#x5B57;&#x4F53;&#x5927;&#x5C0F;&#xFF08;&#x9ED8;&#x8BA4;&#x662F; 12&#xFF09;</td>
</tr>
<tr>
<td style="text-align:left"><code>pdf.fontFamily</code></td>
<td style="text-align:left">&#x57FA;&#x672C;&#x5B57;&#x4F53;&#x6837;&#x5F0F;&#xFF08;&#x9ED8;&#x8BA4;&#x662F; <code>Arial</code>&#xFF09;</td>
</tr>
<tr>
<td style="text-align:left"><code>pdf.paperSize</code></td>
<td style="text-align:left">&#x9875;&#x9762;&#x5C3A;&#x5BF8;&#xFF0C;&#x9009;&#x9879;&#x6709;&#xFF1A; <code>&apos;a0&apos;, &apos;a1&apos;, &apos;a2&apos;, &apos;a3&apos;, &apos;a4&apos;, &apos;a5&apos;, &apos;a6&apos;, &apos;b0&apos;, &apos;b1&apos;, &apos;b2&apos;, &apos;b3&apos;, &apos;b4&apos;, &apos;b5&apos;, &apos;b6&apos;, &apos;legal&apos;, &apos;letter&apos;</code> &#xFF08;&#x9ED8;&#x8BA4;&#x503C;&#x662F; <code>a4</code>&#xFF09;</td>
</tr>
<tr>
<td style="text-align:left"><code>pdf.margin.top</code></td>
<td style="text-align:left">&#x4E0A;&#x8FB9;&#x754C;&#xFF08;&#x9ED8;&#x8BA4;&#x503C;&#x662F; 56&#xFF09;</td>
</tr>
<tr>
<td style="text-align:left"><code>pdf.margin.bottom</code></td>
<td style="text-align:left">&#x4E0B;&#x8FB9;&#x754C;&#xFF08;&#x9ED8;&#x8BA4;&#x503C;&#x662F; 56&#xFF09;</td>
</tr>
<tr>
<td style="text-align:left"><code>pdf.margin.right</code></td>
<td style="text-align:left">&#x53F3;&#x8FB9;&#x754C;&#xFF08;&#x9ED8;&#x8BA4;&#x503C;&#x662F; 62&#xFF09;</td>
</tr>
<tr>
<td style="text-align:left"><code>pdf.margin.left</code></td>
<td style="text-align:left">&#x5DE6;&#x8FB9;&#x754C;&#xFF08;&#x9ED8;&#x8BA4;&#x503C;&#x662F; 62&#xFF09;</td>
</tr>
</tbody>
</table>
<p>&#x751F;&#x6210;&#x7535;&#x5B50;&#x4E66;</p>
<p>GitBook &#x53EF;&#x4EE5;&#x751F;&#x6210;&#x4E00;&#x4E2A;&#x7F51;&#x7AD9;&#xFF0C;&#x4F46;&#x4E5F;&#x53EF;&#x4EE5;&#x8F93;&#x51FA;&#x5185;&#x5BB9;&#x4F5C;&#x4E3A;&#x7535;&#x5B50;&#x4E66;&#xFF08;ePub&#xFF0C;Mobi&#xFF0C;PDF&#xFF09;&#x3002;</p>
<pre><code># Generate a PDF file
$ gitbook pdf ./ ./mybook.pdf

# Generate an ePub file
$ gitbook epub ./ ./mybook.epub

# Generate a Mobi file
$ gitbook mobi ./ ./mybook.mobi
</code></pre><h3 id="&#x5B89;&#x88C5;-ebook-convert">&#x5B89;&#x88C5; ebook-convert</h3>
<p><code>ebook-convert</code> &#x53EF;&#x4EE5;&#x7528;&#x6765;&#x751F;&#x6210;&#x7535;&#x5B50;&#x4E66;&#xFF08;epub&#xFF0C;mobi&#xFF0C;pdf&#xFF09;&#x3002;</p>
<h4 id="gnulinux">GNU/Linux</h4>
<p>&#x5B89;&#x88C5; <a href="https://calibre-ebook.com/download" target="_blank">Calibre application</a>.</p>
<pre><code class="lang-sh">$ sudo aptitude install calibre
</code></pre>
<p>&#x5728;&#x4E00;&#x4E9B; GNU / Linux &#x53D1;&#x884C;&#x7248;&#x4E2D;&#xFF0C;&#x8282;&#x70B9;&#x88AB;&#x5B89;&#x88C5;&#x4E3A; nodejs&#xFF0C;&#x60A8;&#x9700;&#x8981;&#x624B;&#x52A8;&#x521B;&#x5EFA;&#x4E00;&#x4E2A;&#x7B26;&#x53F7;&#x94FE;&#x63A5;&#xFF1A;</p>
<pre><code class="lang-sh"><span class="hljs-variable">$sudo</span> ln <span class="hljs-_">-s</span> /usr/bin/nodejs /usr/bin/node
</code></pre>
<h4 id="os-x">OS X</h4>
<p>&#x4E0B;&#x8F7D;  <a href="https://calibre-ebook.com/download" target="_blank">Calibre application</a>&#x3002;&#x5C06; <code>calibre.app</code> &#x79FB;&#x52A8;&#x5230;&#x5E94;&#x7528;&#x7A0B;&#x5E8F;&#x6587;&#x4EF6;&#x5939;&#x540E;&#xFF0C;&#x521B;&#x5EFA;&#x4E00;&#x4E2A;&#x7B26;&#x53F7;&#x94FE;&#x63A5;&#x5230; <code>ebook-convert</code> &#x5DE5;&#x5177;&#xFF1A;</p>
<pre><code class="lang-sh">$ sudo ln <span class="hljs-_">-s</span> ~/Applications/calibre.app/Contents/MacOS/ebook-convert /usr/bin
</code></pre>
<p>&#x60A8;&#x53EF;&#x4EE5;&#x4F7F;&#x7528; $PATH &#x4E2D;&#x7684;&#x4EFB;&#x4F55;&#x76EE;&#x5F55;&#x66FF;&#x6362; <code>/usr/bin</code> &#x3002;</p>
<h3 id="&#x5C01;&#x9762;">&#x5C01;&#x9762;</h3>
<p>&#x5C01;&#x9762;&#x7528;&#x4E8E;&#x6240;&#x6709;&#x7535;&#x5B50;&#x4E66;&#x683C;&#x5F0F;&#x3002;&#x60A8;&#x53EF;&#x4EE5;&#x81EA;&#x5DF1;&#x63D0;&#x4F9B;&#x4E00;&#x4E2A;&#xFF0C;&#x4E5F;&#x53EF;&#x4EE5;&#x4F7F;&#x7528; <a href="https://plugins.gitbook.com/plugin/autocover" target="_blank">autocover plugin</a>&#x751F;&#x6210;&#x4E00;&#x4E2A;&#x3002;</p>
<p>&#x8981;&#x63D0;&#x4F9B;&#x5C01;&#x9762;&#xFF0C;&#x8BF7;&#x5C06; <code>cover.jpg</code> &#x6587;&#x4EF6;&#x653E;&#x5728;&#x4E66;&#x672C;&#x7684;&#x6839;&#x76EE;&#x5F55;&#x4E0B;&#x3002;&#x6DFB;&#x52A0;&#x4E00;&#x4E2A; <code>cover_small.jpg</code> &#x5C06;&#x6307;&#x5B9A;&#x4E00;&#x4E2A;&#x8F83;&#x5C0F;&#x7248;&#x672C;&#x7684;&#x5C01;&#x9762;&#x3002;&#x5C01;&#x9762;&#x5E94;&#x4E3A; <code>JPEG</code> &#x6587;&#x4EF6;&#x3002;</p>
<p>&#x597D;&#x7684;&#x5C01;&#x9762;&#x5E94;&#x8BE5;&#x9075;&#x5B88;&#x4EE5;&#x4E0B;&#x51C6;&#x5219;&#xFF1A;</p>
<ul>
<li><code>cover.jpg</code> &#x7684;&#x5C3A;&#x5BF8;&#x4E3A; 1800x2360 &#x50CF;&#x7D20;&#xFF0C;<code>cover_small.jpg</code> &#x4E3A; 200x262</li>
<li>&#x6CA1;&#x6709;&#x8FB9;&#x754C;</li>
<li>&#x6E05;&#x6670;&#x53EF;&#x89C1;&#x7684;&#x4E66;&#x540D;</li>
<li>&#x4EFB;&#x4F55;&#x91CD;&#x8981;&#x7684;&#x6587;&#x5B57;&#x5E94;&#x8BE5;&#x5728;&#x5C0F;&#x7248;&#x672C;&#x4E2D;&#x53EF;&#x89C1;</li>
</ul>
<p>Gitbook &#x90E8;&#x7F72;</p>
<h3 id="&#x6258;&#x7BA1;&#x5230;-gitbookcom">&#x6258;&#x7BA1;&#x5230; gitbook.com</h3>
<p><a href="https://www.gitbook.com/" target="_blank">GitBook.com</a> &#x662F;&#x4F7F;&#x7528; GitBook &#x683C;&#x5F0F;&#x521B;&#x5EFA;&#x548C;&#x6258;&#x7BA1;&#x56FE;&#x4E66;&#x7684;&#x5728;&#x7EBF;&#x5E73;&#x53F0;&#x3002;&#x5B83;&#x63D0;&#x4F9B;&#x6258;&#x7BA1;&#xFF0C;&#x534F;&#x4F5C;&#x529F;&#x80FD;&#x548C;&#x6613;&#x4E8E;&#x4F7F;&#x7528;&#x7684;&#x7F16;&#x8F91;&#x5668;&#x3002;</p>
<p><strong>&#x521B;&#x5EFA;&#x65B0;&#x4E66;</strong></p>
<p>&#x5982;&#x4E0B;&#x56FE;&#x6240;&#x793A;&#xFF0C;&#x6839;&#x636E;&#x4E2A;&#x4EBA;&#x9700;&#x6C42;&#xFF0C;&#x9009;&#x62E9;&#x4E00;&#x4E2A;&#x6A21;&#x677F;&#x521B;&#x5EFA;&#x4F60;&#x7684;&#x7535;&#x5B50;&#x4E66;&#x3002;</p>
<p><img src="https://raw.githubusercontent.com/dunwu/gitbook-notes/master/assets/images/gitbook-new-book.png" alt="gitbook-settings"></p>
<p><strong>&#x8BBE;&#x7F6E;&#x4E66;&#x7684;&#x57FA;&#x672C;&#x4FE1;&#x606F;</strong></p>
<p><img src="https://raw.githubusercontent.com/dunwu/gitbook-notes/master/assets/images/gitbook-settings.png" alt="gitbook-settings"></p>
<p><strong>clone &#x5230;&#x672C;&#x5730;</strong></p>
<p>Gitbook.com &#x4F1A;&#x4E3A;&#x6BCF;&#x672C;&#x4E66;&#x521B;&#x5EFA;&#x4E00;&#x4E2A; git &#x4ED3;&#x5E93;&#x3002;</p>
<p>&#x5982;&#x4E0B;&#x56FE;&#x6240;&#x793A;&#xFF0C;&#x62F7;&#x8D1D; git &#x5730;&#x5740;&#xFF0C;&#x7136;&#x540E; <code>git clone</code> &#x5230;&#x672C;&#x5730;&#x3002;</p>
<p><img src="https://raw.githubusercontent.com/dunwu/gitbook-notes/master/assets/images/gitbook-clone.png" alt="gitbook-settings"></p>
<p><strong>&#x53D1;&#x5E03;</strong></p>
<p>&#x5728;&#x672C;&#x5730;&#x6309;&#x7167; Gitbook &#x89C4;&#x8303;&#x7F16;&#x8F91;&#x7535;&#x5B50;&#x4E66;&#xFF0C;&#x7136;&#x540E; <code>git push</code> &#x5230; Gitbook &#x7684;&#x8FDC;&#x7A0B;&#x4ED3;&#x5E93;&#x3002;</p>
<p>&#x9ED8;&#x8BA4;&#x8BBF;&#x95EE;&#x5730;&#x5740;&#x662F;&#xFF1A;<a href="https://xn--eqr924avxo.gitbooks.io/&#x9879;&#x76EE;&#x540D;/content/" target="_blank">https://&#x7528;&#x6237;&#x540D;.gitbooks.io/&#x9879;&#x76EE;&#x540D;/content/</a></p>
<p>&#x4F8B;&#x5982;&#xFF1A;&#x6211;&#x7684;&#x7528;&#x6237;&#x540D;&#x4E3A; dunwu&#xFF0C;&#x4E00;&#x4E2A;&#x7535;&#x5B50;&#x4E66;&#x9879;&#x76EE;&#x540D;&#x4E3A; test&#xFF0C;&#x5219;&#x8BBF;&#x95EE;&#x8DEF;&#x5F84;&#x662F;&#xFF1A; <code>https://dunwu.gitbooks.io/test/content/</code></p>
<p>&#x5F53;&#x7136;&#xFF0C;&#x5982;&#x679C;&#x4F60;&#x6709;&#x81EA;&#x5DF1;&#x7684;&#x57DF;&#x540D;&#xFF0C;&#x4E5F;&#x53EF;&#x4EE5;&#x8BBE;&#x7F6E; Domains &#x9009;&#x9879;&#xFF0C;&#x6765;&#x6307;&#x5B9A;&#x8BBF;&#x95EE;&#x8DEF;&#x5F84;&#x4E3A;&#x4F60;&#x7684;&#x57DF;&#x3002;</p>
<h3 id="&#x6258;&#x7BA1;&#x5230;-github">&#x6258;&#x7BA1;&#x5230; Github</h3>
<p>&#x5982;&#x679C;&#x4F60;&#x4E0D;&#x5E0C;&#x671B;&#x4F7F;&#x7528; Gitbook &#x7684;&#x4ED3;&#x5E93;&#xFF0C;&#x800C;&#x662F;&#x60F3;&#x76F4;&#x63A5;&#x4F7F;&#x7528; Github &#x7684;&#x4ED3;&#x5E93;&#xFF0C;&#x4E5F;&#x662F;&#x53EF;&#x4EE5;&#x7684;&#x3002;</p>
<p>&#x9996;&#x5148;&#xFF0C;&#x4F60;&#x9700;&#x8981;&#x7ED1;&#x5B9A;&#x4F60;&#x7684; Github &#x8D26;&#x53F7;&#x3002;&#x6700;&#x7B80;&#x5355;&#x7684;&#x65B9;&#x5F0F;&#x5F53;&#x7136;&#x5C31;&#x662F;&#x767B;&#x5F55; Gitbook.com &#x65F6;&#x4F7F;&#x7528; Github &#x8D26;&#x53F7;&#x767B;&#x5F55;&#x65B9;&#x5F0F;&#x4E86;&#x3002;&#x5426;&#x5219;&#xFF0C;&#x4F60;&#x4E5F;&#x53EF;&#x4EE5;&#x5728; Account Settings &#x4E2D;&#x7684; Github &#x8BBE;&#x7F6E;&#x9009;&#x9879;&#x4E2D;&#x53BB;&#x8FDB;&#x884C;&#x7ED1;&#x5B9A;&#x3002;</p>
<p><img src="" alt="gitbook-settings"></p>
<p>&#x7ED1;&#x5B9A;&#x4E86; Github &#x8D26;&#x53F7;&#x540E;&#xFF0C;&#x4F60;&#x53EF;&#x4EE5;&#x5728;&#x65B0;&#x5EFA;&#x7535;&#x5B50;&#x4E66;&#x65F6;&#xFF0C;&#x9009;&#x62E9;&#x4ECE;&#x4E00;&#x4E2A;&#x6307;&#x5B9A;&#x7684; Github &#x4ED3;&#x5E93;&#x5BFC;&#x5165;&#x7535;&#x5B50;&#x4E66;&#x9879;&#x76EE;&#x3002;&#x53C2;&#x8003;&#x4E0B;&#x56FE;&#xFF1A;</p>
<p><img src="https://raw.githubusercontent.com/dunwu/gitbook-notes/master/assets/images/gitbook-new-book-with-github.png" alt="gitbook-settings"></p>
<p>&#x53EA;&#x8981;&#x4F60;&#x6307;&#x5B9A;&#x7684; Github &#x4ED3;&#x5E93;&#x4E2D;&#x7684;&#x6587;&#x6863;&#x5185;&#x5BB9;&#x7B26;&#x5408; Gitbook &#x89C4;&#x8303;&#xFF0C;Gitbook &#x5C31;&#x4F1A;&#x81EA;&#x52A8;&#x6839;&#x636E;&#x4F60;&#x7684;&#x6BCF;&#x6B21;&#x66F4;&#x65B0;&#x53BB;&#x6784;&#x5EFA;&#x751F;&#x6210;&#x7535;&#x5B50;&#x4E66;&#x7F51;&#x7AD9;&#x3002;</p>
<p>&#x9ED8;&#x8BA4;&#x8BBF;&#x95EE;&#x5730;&#x5740;&#x662F;&#xFF1A;</p>
<pre><code>https://Github&#x7528;&#x6237;&#x540D;.gitbooks.io/Github &#x4ED3;&#x5E93;/content/
</code></pre><p>&#x4F8B;&#x5982;&#xFF1A;&#x6211;&#x7684;&#x7528;&#x6237;&#x540D;&#x4E3A; dunwu&#xFF0C;Github &#x4ED3;&#x5E93;&#x540D;&#x4E3A; gitbook-notes&#xFF0C;&#x5219;&#x8BBF;&#x95EE;&#x8DEF;&#x5F84;&#x662F;&#xFF1A;</p>
<p><a href="https://dunwu.gitbooks.io/gitbook-notes/content/" target="_blank">https://dunwu.gitbooks.io/gitbook-notes/content/</a></p>
<h4 id="&#x6258;&#x7BA1;&#x5230;-github-pages">&#x6258;&#x7BA1;&#x5230; Github Pages</h4>
<p>&#x4E5F;&#x8BB8;&#x4F60;&#x4EE5;&#x524D;&#x4E5F;&#x4E86;&#x89E3; Github &#x7684;&#x4E00;&#x4E2A;&#x529F;&#x80FD;&#xFF1A; <a href="https://pages.github.com/" target="_blank">GitHub Pages</a> &#x3002;&#x5B83;&#x5141;&#x8BB8;&#x7528;&#x6237;&#x5728; GitHub &#x4ED3;&#x5E93;&#x6258;&#x7BA1;&#x4F60;&#x7684;&#x4E2A;&#x4EBA;&#x3001;&#x7EC4;&#x7EC7;&#x6216;&#x9879;&#x76EE;&#x7684;&#x9759;&#x6001;&#x9875;&#x9762;&#xFF08;&#x81EA;&#x52A8;&#x8BC6;&#x522B; html&#x3001;css&#x3001;javascript&#xFF09;&#x3002;</p>
<p><strong>&#x5EFA;&#x7ACB; xxx.github.io &#x4ED3;&#x5E93;</strong></p>
<p>&#x8981;&#x4F7F;&#x7528;&#x8FD9;&#x4E2A;&#x7279;&#x6027;&#xFF0C;&#x9996;&#x5148;&#xFF0C;&#x4F60;&#x5FC5;&#x987B;&#x5EFA;&#x7ACB;&#x4E00;&#x4E2A;&#x4E25;&#x683C;&#x9075;&#x5FAA;&#x4EE5;&#x4E0B;&#x547D;&#x540D;&#x8981;&#x6C42;&#x7684;&#x4ED3;&#x5E93;&#xFF1A;<code>Github&#x8D26;&#x53F7;&#x540D;.github.io</code>&#x4E3E;&#x4F8B;&#xFF0C;&#x6211;&#x7684; Github &#x8D26;&#x53F7;&#x4E3A; dunwu&#xFF0C;&#x5219;&#x8FD9;&#x4E2A;&#x4ED3;&#x5E93;&#x5E94;&#x8BE5;&#x53EB; <code>dunwu.github.io</code>&#x3002;&#x901A;&#x5E38;&#xFF0C;&#x8FD9;&#x4E2A;&#x4ED3;&#x5E93;&#x88AB;&#x7528;&#x6765;&#x4F5C;&#x4E3A;&#x4E2A;&#x4EBA;&#x6216;&#x7EC4;&#x7EC7;&#x7684;&#x535A;&#x5BA2;&#x3002;</p>
<p><strong>&#x5EFA;&#x7ACB; gh-pages &#x5206;&#x652F;</strong></p>
<p>&#x5B8C;&#x6210;&#x7B2C;1&#x6B65;&#x540E;&#xFF0C;&#x5728;&#x4EFB;&#x610F;&#x4E00;&#x4E2A; Github &#x4ED3;&#x5E93;&#x4E2D;&#x5EFA;&#x7ACB;&#x4E00;&#x4E2A;&#x540D;&#x4E3A; <code>gh-pages</code> &#x7684;&#x5206;&#x652F;&#x3002;&#x53EA;&#x8981; <code>gh-pages</code> &#x4E2D;&#x7684;&#x5185;&#x5BB9;&#x7B26;&#x5408;&#x4E00;&#x4E2A;&#x9759;&#x6001;&#x7AD9;&#x70B9;&#x8981;&#x6C42;&#xFF0C;&#x5C31;&#x53EF;&#x4EE5;&#x5728;&#x5982;&#x4E0B;&#x5730;&#x5740;&#x4E2D;&#x8FDB;&#x884C;&#x8BBF;&#x95EE;&#xFF1A;<code>https://Github&#x7528;&#x6237;&#x540D;.gitbooks.io/Github &#x4ED3;&#x5E93;</code> &#x3002;&#x4F8B;&#x5982;&#xFF1A;&#x6211;&#x7684;&#x4E00;&#x4E2A; Github &#x4ED3;&#x5E93;&#x540D;&#x4E3A; react-notes&#xFF0C;&#x5219;&#x8BBF;&#x95EE;&#x8DEF;&#x5F84;&#x662F;&#xFF1A;<code>https://dunwu.github.io/react-notes</code></p>
<p><strong>&#x81EA;&#x52A8;&#x5316;&#x53D1;&#x5E03;&#x5230; gh-pages</strong></p>
<p>&#x5982;&#x679C;&#x6BCF;&#x6B21;&#x90FD;&#x624B;&#x52A8; git push &#x5230;&#x8FDC;&#x7A0B; gh-pages &#x5206;&#x652F;&#xFF0C;&#x7565;&#x6709;&#x70B9;&#x9EBB;&#x70E6;&#x3002;</p>
<p>&#x600E;&#x4E48;&#x5B9E;&#x73B0;&#x81EA;&#x52A8;&#x5316;&#x53D1;&#x5E03;&#x5462;&#xFF1F;</p>
<p>&#x6709;&#x4E24;&#x79CD;&#x65B9;&#x6CD5;&#xFF1A;</p>
<p><strong>&#x4F7F;&#x7528; gh-pages &#x63D2;&#x4EF6;</strong></p>
<p>&#x5982;&#x679C;&#x4F60;&#x4E86;&#x89E3; Nodejs&#xFF0C;&#x90A3;&#x4E48;&#x6700;&#x7B80;&#x5355;&#x7684;&#x53D1;&#x5E03;&#x65B9;&#x5F0F;&#x5C31;&#x662F;&#x4F7F;&#x7528; <code>gh-pages</code> &#x63D2;&#x4EF6;&#x3002;</p>
<p>&#x5148;&#x5728;&#x672C;&#x5730;&#x5B89;&#x88C5;&#x63D2;&#x4EF6;</p>
<pre><code>$ npm i -D gh-pages
</code></pre><p>&#x7136;&#x540E;&#xFF0C;&#x5728; package.json &#x6587;&#x4EF6;&#x4E2D;&#x6DFB;&#x52A0;&#x811A;&#x672C;&#x547D;&#x4EE4;&#xFF1A;</p>
<p>&#x5982;&#x4E0B;&#xFF1A;<code>-d</code> &#x547D;&#x4EE4;&#x53C2;&#x6570;&#x540E;&#x9762;&#x662F;&#x8981;&#x53D1;&#x5E03;&#x7684;&#x9759;&#x6001;&#x7AD9;&#x70B9;&#x5185;&#x5BB9;&#x7684;&#x76EE;&#x5F55;</p>
<pre><code class="lang-json"><span class="hljs-string">&quot;scripts&quot;</span>: {
  <span class="hljs-string">&quot;deploy&quot;</span>: <span class="hljs-string">&quot;gh-pages -d build&quot;</span>
},
</code></pre>
<p><strong>&#x811A;&#x672C;</strong></p>
<p>&#x5199;&#x4E00;&#x4E2A;&#x6267;&#x884C; git &#x547D;&#x4EE4;&#x7684;&#x811A;&#x672C;&#x5C31;&#x641E;&#x5B9A;&#x4E86;&#x3002;</p>
<p>&#x4E0B;&#x9762;&#x7684;&#x811A;&#x672C;&#x65E0;&#x8BBA;&#x662F;&#x5728; bat &#x6216; sh &#x811A;&#x672C;&#x4E2D;&#x90FD;&#x53EF;&#x4EE5;&#x6267;&#x884C;&#x3002;</p>
<pre><code>cd build
git init
git checkout -b gh-pages
git add .
git commit -am &quot;Update&quot;
git push git@github.com:dunwu/gitbook-notes gh-pages --force&quot;
</code></pre><p>&#x8D44;&#x6E90;</p>
<h3 id="&#x5B98;&#x65B9;&#x8D44;&#x6E90;">&#x5B98;&#x65B9;&#x8D44;&#x6E90;</h3>
<ul>
<li><a href="https://github.com/GitbookIO/gitbook" target="_blank">Gitbook Github</a></li>
<li><a href="https://www.gitbook.com/" target="_blank">Gitbook &#x5B98;&#x7F51;</a></li>
<li><a href="https://toolchain.gitbook.com/" target="_blank">Gitbook Toolchain &#x6587;&#x6863;</a></li>
<li><a href="https://help.gitbook.com/" target="_blank">Gitbook &#x5E2E;&#x52A9;&#x4E2D;&#x5FC3;</a></li>
</ul>
<h3 id="&#x6559;&#x7A0B;&#x8D44;&#x6E90;">&#x6559;&#x7A0B;&#x8D44;&#x6E90;</h3>
<ul>
<li><a href="https://github.com/zhangjikai/gitbook-use" target="_blank">gitbook-use</a> by zhangjikai</li>
</ul>
<h3 id="&#x5DE5;&#x5177;">&#x5DE5;&#x5177;</h3>
<ul>
<li><a href="https://www.gitbook.com/editor" target="_blank">Gitbook &#x7F16;&#x8F91;&#x5668;</a></li>
</ul>

                                
                                </section>
                            
    </div>
    <div class="search-results">
        <div class="has-results">
            
            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
            <ul class="search-results-list"></ul>
            
        </div>
        <div class="no-results">
            
            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
            
        </div>
    </div>
</div>

                        </div>
                    </div>
                
            </div>

            
                
                <a href="./" class="navigation navigation-prev " aria-label="Previous page: 第一章 node.js">
                    <i class="fa fa-angle-left"></i>
                </a>
                
                
                <a href="食.html" class="navigation navigation-next " aria-label="Next page: 第2节：食">
                    <i class="fa fa-angle-right"></i>
                </a>
                
            
        
    </div>

    <script>
        var gitbook = gitbook || [];
        gitbook.push(function() {
            gitbook.page.hasChanged({"page":{"title":"第1节：GitBook 从懵逼到入门","level":"1.2.1","depth":2,"next":{"title":"第2节：食","level":"1.2.2","depth":2,"path":"Chapter1/食.md","ref":"Chapter1/食.md","articles":[]},"previous":{"title":"第一章 node.js","level":"1.2","depth":1,"path":"Chapter1/README.md","ref":"Chapter1/README.md","articles":[{"title":"第1节：GitBook 从懵逼到入门","level":"1.2.1","depth":2,"path":"Chapter1/GitBook.md","ref":"Chapter1/GitBook.md","articles":[]},{"title":"第2节：食","level":"1.2.2","depth":2,"path":"Chapter1/食.md","ref":"Chapter1/食.md","articles":[]},{"title":"第3节：住","level":"1.2.3","depth":2,"path":"Chapter1/住.md","ref":"Chapter1/住.md","articles":[]},{"title":"第4节：行","level":"1.2.4","depth":2,"path":"Chapter1/行.md","ref":"Chapter1/行.md","articles":[]}]},"dir":"ltr"},"config":{"plugins":["livereload"],"styles":{"website":"styles/website.css","ebook":"styles/ebook.css","pdf":"styles/pdf.css","mobi":"styles/mobi.css","epub":"styles/epub.css"},"pluginsConfig":{"livereload":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"kim","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"language":"zh-hans","links":{"sidebar":{"洲博通外综服务":"http://localhost:3000/customer/customerManage"}},"gitbook":"*","description":"洲博通外综服务开发文档"},"file":{"path":"Chapter1/GitBook.md","mtime":"2019-05-22T03:41:05.988Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-06-05T07:56:23.469Z"},"basePath":"..","book":{"language":""}});
        });
    </script>
</div>

        
    <script src="../gitbook/gitbook.js"></script>
    <script src="../gitbook/theme.js"></script>
    
        
        <script src="../gitbook/gitbook-plugin-livereload/plugin.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-search/search-engine.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-search/search.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-sharing/buttons.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
        
    

    </body>
</html>

